home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 March / EnigmA AMIGA RUN 35 (1999)(G.R. Edizioni)(IT)[!][issue 1999-03].iso / earcd / devel / libx11 / docs / libx11.readme < prev    next >
Text File  |  1999-01-01  |  3KB  |  69 lines
  1.  
  2.   Some LibX11 info:
  3. --------------------
  4. As you may have guessed, this program uses something I have called libX11 which
  5. is a link library of X11 emulation routines. It tries to provide an easy way
  6. of making programs written for the X11 window system run on the amiga.
  7. To do this I have used a lot of different amiga functions, some of them
  8. may not bee too portable across different configurations (most notably
  9. those with gfx cards). I have been informed that some Blitter functions
  10. doesn't do too well on those gfx cards. The library uses BltPattern/
  11. BltBitMap/BltBitMapRastPort and BltMaskBitMapRastPort both for 1 plane
  12. and >1 plane bitmaps. Some functions also uses the chunky to planar routines
  13. by Morten Eriksen (it may not be the fastest but at least it is general
  14. enough to be useful!) which has been reported not to work on gfx cards.
  15. To prevent these functions from beeing used set 'setenv X11/gfxcard 1'
  16. (not all programs may use these functions!).
  17.  
  18.  Resources
  19. -----------
  20. To handle fonts a file called AmigaDefaults (==.XDefaults) that contains
  21. information on mapping between X11 fonts and amiga fonts, has been made.
  22. (and other info when I improve upon it..environment vars are likely contenders..)
  23. It should be placed in your $HOME. (ex. 'setenv HOME dh1:') or in
  24. $X11HOME if it is defined. 
  25.  
  26. fontmap.courier: courier.font
  27. fontmap.helvetica: helvetica.font
  28.  
  29. are valid entries into this library where the string between . and : is the
  30. substring that when it matches a requested fontname will map the font into
  31. the fontname following the colon. A program may ask for
  32. "-adobe-helvetica-medium-r-*--" and will in this case receive the helvetica.font.
  33. If you have bitmap versions of the postscript fonts you may insert them
  34. into this file! (in case you are working with xfig..) I guess it should
  35. be possible to convert those fonts into something usable on the amiga
  36. with some of those font editors.
  37.  
  38. This file can now also contain resource entries that programs will ask
  39. for like 'XMgr.invertDraw: no'. To find out what resources each program
  40. asks for you can turn on debugging with 'setenv X11/debug 1' (hm..will be
  41. 'Amiga.debug: true' real soon..) or read the manual!
  42.  
  43.  Cursors
  44. ---------
  45. If you don't like the cursors that the applications may choose to use
  46. you can override it with 'setenv X11/Cursors 0'. They may look ugly
  47. but are the default cursors of the X11 window system. 
  48.  
  49.  Colors
  50. --------
  51. To provide proper color handling a file called rgb.txt has to be placed in
  52. the same dir as AmigaDefaults (HOME or X11HOME) it contains mapping between
  53. color names and rgb values. (used by XLookupColor/XParseColor and 
  54. XAllocNamedColor). Also under os 3.0 pensharing is used to obtain pens. 
  55. Without this file programs may decide there wasn't any colors available
  56. and will use black & white.
  57.  
  58.  Other
  59. -------
  60. If you want to run an application on a public screen most of the programs
  61. will react to a command line entry '-display PubScreen'. If it doesn't
  62. 'setenv X11/usepub PubScreen' can be used.
  63.  
  64. Some debug information can be obtained by 'setenv X11/debug 1'. Most programs
  65. also provide its own debug command line option.
  66.  
  67. setenv X11/askmode 1 is used with xanim to specify the screenmode which the
  68. anim is showed on.
  69.